Typical settings and usage of ADC bean
Typické nastavenie a použitie ADC beanu (prevodníka ANALOG na DIGITAL)

• (1) Continuous conversion of all channels, with interrupt service  
         Kontinuálna konverzia všetkých kanálov, pomocou služby prerušenia
  
• (2) One conversion of all channels, with interrupt service  
         Jedna konverzia všetkých kanálov, s použitím služby prerušenia.
  
• (3) One conversion of a specified channel, with interrupt service  
        Jedna konverzia špecifikovaného kanála, s použitím služby prerušenia
  
• (4) One conversion of all channels, in polling mode  
        Jedna konverzia všetkých kanálov, v pool režime
  
• (5) One conversion of all channels of each bean, in shared mode  
        Jedna konverzia všetkých kanálov každého beanu, v sdielanom režime
  

(1) Continuous conversion of all channels, with interrupt service

Kontinuálna konverzia všetkých kanálov, so službou prerušenia

Conversion of all channels/samples is performed repeatedly (using interrupts).
Property Interrupt service is enabled, Number of conversion is set to 1. Conversion is started using Start method. When a conversion of all channels/samples is finished the OnEnd event is invoked and a new set of measured values is available. All these measured values are available for reading until the next measurement cycle is finished. Conversion can be stopped using Stop method.
Konverzia všetkých kanálov/vzoriek je prevádzaná opakovane (s použitím prerušení). Vlastnosť Služba prerušenia ( Interrupt service ) je povolená, počet konverzií ( Number of conversion ) je nastavený na 1. Konverzi aje odštartovaná použitím metódy Start ( Start  ). Keď konverzia všetkých kanálov/vzoriek je ukončená vyvolá sa udalosť  OnEnd a je k dispozícii nová množina nameraných hodnôt. Všetky tieto namerané hodnoty sú dostupné na čítanie pokiaľ sa nedokončí nový cyklus meraní. Konverzia môže byť ukončená použitím metódy  Stop  .

The example demonstrates the continuous conversion of three channels/samples.
Príklady demonštrujú kontinuálnu konverziu troch kanálov/vzoriek. 

 MAIN.C

#define NUM_MEASUREMENTS 10


unsigned int EvnCnt = 0;
byte Values[3];
void main(void)
{
  . . .
  AD1_Start();        // Run measurements 
  //measured data are processed in the events
  //this cycle waits for end
  for(;;) {
    if (EvntCnt == NUM_MEASUREMENTS) {
       //after 10 cycles the conversion is stopped
       AD1_Stop();
    }
    . . .
}
}

 EVENTS.C

extern unsigned int EvnCnt;
extern byte Values[3];

void AD1_OnEnd(void)
{
  EvnCnt++;           // Increment counter
  //measured values are available and may be read:
  AD1_GetValue((byte *)Values);  // Get AD conversion results
}

This chart shows a sequence of continuous conversion of all channels if an A/D peripheral does not support measuring all channels at once. 
Tieto obrázky ukazujú sekvenciu kontinuálnej konverzie všetkých kanálov ak A/D periféria nepodporuje naraz meranie všetkých kanálov. 

This chart shows a sequence of continuous conversion of all channels if an A/D peripheral supports measuring all channels simultaneously. 
Tento obrázok popisuje sekvenciu kontinuálneho merania všetkých kanálov ak A/D periféria podporuje meranie všetkých kanálov simultánne. 

This chart shows a sequence of continuous conversion of all channels if an A/D peripheral supports measuring all channels simultaneously and in addition continuous mode.
Tento obrázok popisuje sekvenciu kontinuálnej konverzie všetkých kanálov ak A/D periféria podporuje meranie všetkých kanálov simultánne a v  prídavnom kontinuálnom móde. 

(2) One conversion of all channels, with interrupt service  

Jedna konverzia všetkých kanálov s obsluhou prerušenia.

All channels are measured after Measure method is invoked. Property Interrupt service is enabled, Number of conversion is set to 1. When a conversion of all channels/samples is finished the OnEnd event is invoked and measured values are available (at least until the next conversion is started).
Všetky kanály sú merané po tom ako sa vyvolá metóda  Measure . Vlastnosť  Interrupt service - obsluha prerušenia je povolená,  Number of conversion - počet konverzií je nastavený na 1. Keď konverzia všetkých kanálov/vzoriek je ukončená, je vyvolaná udalosť  OnEnd a merané hodnoty sú dostupné (prinajmenšom dovtedy kým sa neštartne nasledovná konverzia). 

The following example demonstrates conversion of all channels.
Nasledovný príklad demonštruje konverziu všetkých kanálov. 

 MAIN.C

bool ValuesAvailable = FALSE;  // control variable
byte Values[3];
void main(void)
{
  AD1_Measure(TRUE);
  AD1_GetValue((byte *)Values);  // Get AD conversion results
  . . .
  for(;;) {
    if (ValuesAvailable) {
      // MIESTO KDE SA DAJÚ POUŽIŤ ÚDAJE UMIESTNENÉ VO Values 
      ValuesAvailable = FALSE;   // clear the control variable
      AD1_Measure(FALSE);  //start next measurement
    }
    . . .
  }
}

 EVENTS.C

extern bool ValuesAvailable;
extern byte Values[3];

void AD1_OnEnd(void)
{
  AD1_GetValue((byte *)Values);  // Get AD conversion results
  ValuesAvailable = TRUE;        // set control variable
}

This chart shows a sequence of measurements on all channels if an A/D peripheral does not support measuring all channels simultaneously.
Tento obrázok ukazuje sekvenciu meraní všetkých kanálov ak A/D periféria nepodporuje meranie všetkých kanálov simultánne. 

 

Popis princípu V obrázku vidíte tri veci Užívateľský program Software riadiaci ADC bean Hardware ADC beanu Verzia s parametrom FALSE Po tom ako sa rozhodnete merať spustíte program Measure, ktorý pripraví bean na činnosť a odštartuje operáciu launch(0), ktorá má odmerať vzorku 0. Nakoľko budeme používať prerušenie, môže bean ukončiť program (svetlo zelený) a vrátiť sa do hlavného programu kde sa bude pokračovať zatiaľ na iných úlohách. Hardware zatiaľ meria údaj a to trvá určitú dobu (naznačenú modrou). Ak meranie skončí dôjde k prerušeniu hlavného progranu a vstúpime do obsluhy prerušenia beanu. Tento si pamätá, že čaká na hodnotu 0, preto ju niekam uloží a odštartuje operáciu launch(1) pre vzorku 1. Hneď potom sa vráti do hlavného programu, ktorý si plní svoje úlohy. Meranie hodnoty skončí a vyvolá sa prerušenie beanu. Zase sa uloží nameraná hodnota a odštartuje sa launch(2) meranie poslednej vzorky 2. Ako v predošlých prípadoch sa vrátime do hlavného programu. Po domeraní dôjde k poslednému prerušeniu. Bean má tri vzorky zavolá podprogram OnEnd() ktorá slúži na použitie výsledku merania a do ktorej obsahu ste mohli pridať vlastný obslužný kód. Ten po skončení sa vráti do obsluhy beanu, ktorý deaktivuje a vráti sa už natrvalo do hlavného programu.

Verzia s parametrom TRUE Líši sa len v tom že obsluha beanu nevracia sa do hlavného programu, t.j. všetky ostatné činnosti vtedy stoja a bean čaká na výsledok merania.

This chart shows a sequence of measurements on all channels if an A/D peripheral supports measuring all channels simultaneously. Number of measurement is set to 2.
Tento obrázok ukazuje meranie všetkých kanálov ak A/D periféria podporuje meranie všetkých kanálov simultánne. Počet meraní je nastavené na 2. 

(3) One conversion of a specified channel, with interrupt service  

The conversion of single channel can be done using MeasureChan method. Property Interrupt service is enabled, Number of conversion is set to 1. When a conversion of a channel/sample is finished the OnEnd event is invoked and the measured value is available by until the next conversion is started.
Konverzia jednoduchého kanála može byť uskutočnená použitím metódy  MeasureChan. Vlastnosť   Interrupt service t.j. obsluha prerušenia je povolená, Number of conversion - počet konverzií (A/D) je nastavený na 1. Keď je konverzia kanálu/vzorky ukončená vyvolá sa udalosť  OnEnd a meraná hodnota je dostupná do času pokiaľ sa nasledovná konverzia neodštartuje. 

The following example demonstrates periodic measurement of three channels in the loop.
Nasledovný príklad demonštruje periodické meranie troch kanálov v cykle.

 MAIN.C

bool ValueAvailable = FALSE;  // control variable
byte Value;
byte channel = 0;

void main(void)
{
  . . .
  AD1_MeasureChan(TRUE, channel);
  AD1_GetChanValue(channel, &Value);
  for(;;) {
    if (ValueAvailable) {
      ValueAvailable = FALSE;   // clear the control variable
      // an action, i.e. process the measured value
      ++channel;
      if (channel > 3) channel = 0;
      AD1_MeasureChan(FALSE, channel);
    }
    . . .
  }
}

 EVENTS.C

extern bool ValueAvailable;
extern byte Value;
extern byte channel;

void AD1_OnEnd(void)
{
  // Get AD conversion results of the specified channel
  AD1_GetChanValue(channel, &Value);
  ValueAvailable = TRUE;          // set control variable
}

The following chart shows single conversion of selected channel, the first conversion without waiting for a result and the second conversion with waiting for a result.
Nasledovný obrázok ukazuje jednoduchú konverziu navoleného kanála, prvá konverzia je bez čakania na výsledok a druhá konverzia je s čakaním na výsledok

Popis princípu V obrázku vidíte tri veci Užívateľský program Software riadiaci ADC bean Hardware ADC beanu Verzia s parametrom FALSE Po tom ako sa rozhodnete merať spustíte program MeasureChan, ktorý pripraví bean na činnosť a odštartuje operáciu launch(1), ktorá má odmerať vzorku 1. Nakoľko budeme používať prerušenie, môže bean ukončiť program (svetlo zelený) a vrátiť sa do hlavného programu kde sa bude pokračovať zatiaľ na iných úlohách. Hardware zatiaľ meria údaj a to trvá určitú dobu (naznačenú modrou). Ak meranie skončí dôjde k prerušeniu hlavného progranu a vstúpime do obsluhy prerušenia beanu. Bean zavolá  podprogram OnEnd() ktorá slúži na použitie výsledku merania a do ktorej obsahu ste mohli pridať vlastný obslužný kód. Ten po skončení sa vráti do obsluhy beanu, ktorý deaktivuje a vráti sa už natrvalo do hlavného programu.

Verzia s parametrom TRUE Líši sa len v tom že obsluha beanu nevracia sa do hlavného programu, t.j. všetky ostatné činnosti vtedy stoja a bean čaká na výsledok merania.

(4) One conversion of all channels, in polling mode  

The measurement on all channels is performed in Measure method, i.e., Measure method does not finish until the conversion of all channels is finished. Property Interrupt service is disabled, Number of conversion is set to 1. 
Meranie všetkých kanálov je vykonané v  Measure  /Meranie/ metóde, t.j.  Measure metóda sa neskončí skôr pokiaľ konverzia všetkých kanálov sa neskončí. Vlastnosť  Interrupt service - obsluha prerušenia je zakázaná,  Number of conversion - počet meraní je nastavený na 1. 

 MAIN.C

bool ValuesAvailable = FALSE;  // control variable
byte Values[3];

void main(void)
{
  . . .
  AD1_Measure(FALSE);  // measure all channel, not wait for result
  while (AD1_GetValue((byte *)Values) == ERR_NOTAVAIL);  // Wait for result
  . . .
  AD1_Measure(TRUE);  // measure all channel, wait for result
  AD1_GetValue((byte *)Values);  // Get AD conversion results
  .
. .
}

This chart shows a sequence of conversion of all channels if an A/D peripheral does not support measuring all channels simultaneously. 
Tento obrázok popisuje konverziu všetkých kanálov ak A/D periféria nepodporuje meranie všetkých kanálov simultánne. (Poznámka autora slovenského textu: Nasledovný obrázok je podozrivý, lebo pri parametri FALSE by mal nastať návrat do hlavného programu /pozrite si nasledovný obrázok ktorý je správny/. Pri zakázanom prerušení by však neexistovala metóda ako sa vrátiť do obsluhy beanu ADC. )

This chart shows a sequence of conversion of all channels if an A/D peripheral supports measuring all channels at once.
Tento obrázok popisuje sekvenciu konverzie všetkých kanálov ak A/D periféria podporuje meranie všetkých kanálov naraz.  

This chart shows a sequence of conversion of all channels if an A/D peripheral supports measuring all channels simultaneously. Number of conversion is set to 2.
Tento obrázok popisuje sekvenciu konverzie všetkých kanálov ak A/D periféria podporuje meranie všetkých kanálov simultánne.  Number of conversion - počet konverzií je nastavený na 2. 

(5) One conversion of all channels of each bean, in shared mode  

Several ADC beans can be used for one ADC device. This example assumes that two AD converter beans 'AD1' and 'AD2' in the project share one ADC device (Sharing properties set to enabled). Two channels (AN0 and AN2 pins) are set in the bean 'AD1' and one channel (AN1 pin) is set in the bean 'AD2'. Number of conversion of each bean is set to 1.
Niekoľko ADC beanov môže byť použitých pre jedno ADC zariadenie. Tento príklad predpokláda, že dva AD prevodníkové beany 'AD1' a 'AD2' v projekte zdieľajú jedno ADC zariadenie.   (Sharing properties - zdielané vlastnosti nastavené na povolené). Tva kanály AN0 a AN1 piny) sú nastavené v beane 'AD1' a jeden kanál  (AN1 pin) je nastavený v beane 'AD2'.

 MAIN.C

bool ADResult1;       // Flag for bean 'AD1'
bool ADResult2;       // Flag for bean 'AD2'
byte Values[2];       // Bean 'AD1' is set to two channels measurement
byte Value;           // Bean 'AD2' is set to one channels measurement
void main(void)
{
  ADResult1 = FALSE;
  ADResult2 = FALSE;
  AD1_Measure(FALSE); // Run measurement of two channels from bean 'AD1'
  AD2_Measure(FALSE); // Run measurement of two channels from bean 'AD2'
  .
. .
  while (!ADResult1);            // Wait for measurement complete
  AD1_GetValue8((byte *)Values); // Get AD conversion results of bean 'AD1'
  while (!ADResult2);            // Wait for measurement complete
  AD1_GetValue8(&Value);         // Get AD conversion result of bean 'AD2'
}

 EVENTS.C

extern bool ADResult1;
extern bool ADResult2;
void AD1_OnEnd(void)
{
  /* Measurement of two channels from bean 'AD1' is completed */
  ADResult1 = TRUE;
}

void AD2_OnEnd(void)
{
  /* Measurement of one channel from bean 'AD2' is completed */
  ADResult2 = TRUE;
}